Data ultimo aggiornamento: 22/05/2018

Strumenti di amministrazione - BusAdminTools

A partire da Business 2013 è disponibile il programma BusAdminTools per effettuare manutenzioni di carattere sistemistico. Tale programma è accessibile come procedura indipendente da Business e richiede che questo non sia in esecuzione: scelta la voce dal menu avvio, ci si può autenticare esclusivamente con un utente amministratore di Business.

Sezione Aggiornamento archivi e dati

Da questa sezione possiamo scegliere gli archivi da elaborare e se aggiornarne la struttura e/o i dati. L'aggiornamento archivi va eseguito sempre dopo un aggiornamento di release e può essere necessario in alcuni aggiornamenti intermedi di service release.

NB: durante l'aggiornamento dei profili import/export, in caso non sia stato possibile aggiornare una procedura standard in quanto utilizzata in un profilo di import/exportpersonalizzato, nel log verrà scritta la lista delle procedure e dei profili interessati. Il messaggio in questione lo da quando una (o più) procedura STANDARD (da 1 a 1000) è stata utilizzata in profili NON STANDARD. In questo caso lo segnala informando che non ne compie l'aggironamento (vedi file di log BusAdminTools*.log). E' sempre buona norma, quando si fanno profili IE, non utilizzare le procedure standard ma duplicarle ed utilizzare quelle duplcate per evitare problemi al profilo custom in seguito ad un eventuale aggironamento di NTS.

- Ricostruisci gli indici al termine, ricostruiscono gli indici di SQL. Molto utile per velocizzare SQL, soprattutto quando si fa un cambio di SQL Server.
Abilitare la spunta per far si che al termine della conversione il programma provveda a ricreare (REBUILD) gli indici dei database, operazione che migliora le prestazioni del database e contribuisce a ridurre lo spazio allocato all'interno dei file del database;

- Converti i campi di testo in Unicode, aggiunta la possibilità di inserire\modificare il tipo di dato NVARCHAR: se un database non è Unicode sarà possibile selezionare sia VARCHAR che NVARCHAR; se il database è Unicode, sarà disponibile solo il tipo di dato NVARCHAR.

- Verifica la presenza di campi da cancellare, il nuovo flag serve per decidere se trattare i campi da cancellare dal database o meno. In caso si scelga di non trattarli non verrà cancellato nessun campo dal database, altrimenti verrà mostrata la lista dei campi che andrebbero rimossi e l'utente potrà decidere cosa fare.

Aggiunto un campo nella griglia degli "Archivi da elaborare" che mostra la versione dell'archivio, per valutare se da aggiornare alla versione del modello standard indicato in alto.

NB: con le ultime versioni del busadmintools, prima di eseguire un aggiornamento struttura o un aggiornamento dati di un qualsiasi database (archivio procedura o databse azienda), il BusAdminTools controlla se l'ultimo backup completo è più vecchio di 7 giorni e nel caso lo fosse logga e blocca l'aggiornamento, a meno di non inserire manualmente 'OK' alla finestra di conferma.

Prima della conversione il database con modello di recupero "Con registrazione completa" viene impostato con modello "Con registrazione minima", per limitare le dimensioni dei log, e poi ripristinato al valore originario.

Sezione: Varie

Nella sezione "Varie", la parte di "Verifica\estrazione personalizzazioni" è dedicata alla conversione dei database personalizzati. Prima di lanciare l'aggiornamento archivi occorre realizzare i file modello PROVA.MODXP per i database azienda e ARCPROC.MODXP per la procedura, a seconda delle personalizzazioni effettuate; i file *.MODXP integrano i file *.MODX (modello standard). I modelli personalizzati rilevano oltre a tabelle e colonne aggiunte, anche indici, trigger, viste e stored procedure. Per quest'ultime inoltre viene fatto un controllo sulle stored procedure standard, dove è stato aggiunto l'hash code del corpo della procedura. BusAdminTool utilizzerà questo hash code per verificare se le procedure standard sono state personalizzate, per decidere se aggiungerle o meno durante la generazione del PROVA.MODXP, inoltre al termine tutte le store procedure identificate come personalizzate vengono mostrate all'operatore con un elenco tramite un'apposita finestra a video. Questo perchè la modifica di stored procedure standard è una procedura abbastanza delicata e quindi si vuole dare il più possibile degli strumenti di controllo all'operatore che tratta tali personalizzazioni. Comunque nel caso in cui si volesse estarre solo specifiche stored procedure/trigger/viste è possibile elencarne i nomi all'interno della stored porcedure bussp_procedure_pers presente sia nel database archivio procedura che nel database azienda, indicando la lista dei nomi delle Stored Procedure, Trigger e Viste personalizzate; se questa stored procedure non ritorna nulla, il programma estrae tutte quelle personalizzate, mentre se ritorna una lista di nomi, BusAdminTool estrarrà solo le procedure indicate.

NB: La generazione del *.MODXP scarta le tabelle, viste e stored procedures specifiche di Business File e GOW (nome %HHNTSPJ% oppure con nome %ASPNET% ), programmi gestiti direttamente da NTS Project .

Quindi supponendo di aggiungere una o più tabelle tramite il pulsante modifica struttura DB su un database, ed inserendo il record relativo ad ogni tabella aggiunta nella tabella ORDERTBL di ARCPROC (può essere fatto da Sql Management, oppure anche da apposito tasto in alto a destra OrderTbl).

Lanciando poi la funzione di genera MODXP, questa confronta il database fisico su sql (che ha la tabella aggiunta) con il modello della struttura standard del databse di Business (MODX) e se trova delle variazioni alla struttura (ad esempio tabella aggiunte, campi aggiunti gestiti da business) crea il modello della struttura personalizzata MODXP.
NB: al nel caso in cui viene generato il MODXP viene chiesto all'utente un nome che viene salvato sul file del modello stesso.

Successivamente tale modello personalizzato, se salvato dov'è presente il MODX, verrà rilevato all'avvio del busadmintools e mostrato nel punto indicato sotto la descrizione inserita in precedenza.

In queste condizioni è possibile lanciare l'aggiorna struttura per allineare i database di sql con la struttura data dal modello standard MODX più l'eventuale modello personalizzato MODXP.

Una volta generato il MODXP è possibile visualizzarlo con l'apposito tasto, e tra le varie funzioni durante la visualizzazione è possibile anche caricare dei dati all'interno di tale modello in modo che vengano distribuiti. Se nei dati da distribuire si indicare per il codice ditta *, il programma provvederà ad inserire il dato su tutte le ditte presenti sul database. Sempre in merito ai dati nel momento in cui viene generato l'ARCPROC.MODXP vengono automaticamenti caricati i record che hanno la colonna pers impostata ad S, delle tabelle:

• NOMPROP (definizione delle opzioni di registro, i record personalizzazi vanno alimantati da Sql Management)
• VALPROP (definizione dei valori delle opzioni di registro, i record personalizzazi vanno alimantati da Sql Management)
• TABELLE (elenco delle tabelle del gestionale, i record personalizzazi vanno alimantati da Sql Management oppure anche da apposito tasto in alto a destra 'Agg. def. tabelle\campi' della finestra 'Modifica struttura DB')
• CAMPI (elenco dei campi delle tabelle del gestionale, i record personalizzazi vanno alimantati da Sql Management oppure anche da apposito tasto in alto a destra 'Agg. def. tabelle\campi' della finestra 'Modifica struttura DB')

Particolarità: esistono delle tabelle (riservate per NTS Project) con prefisso "TABNJ", "hhntspj" e "aspnet". Queste tabelle verranno automaticamente escluse dalla generazione del prova.modxp, in aggiunta queste tabelle (riservate per NTS Project) contenute nella ORDERTBL non vengono più eliminate dopo una conversione (record di ordertbl). Aggiunta nuova opzione del regedit (non del registro di business, vedere img) "EstraiNTSPJ", con valore -1 il programma ignora i blocchi precedenti di NTSProject ed estrae comunque tutte le tabelle.

Il pulsante "Crea server DSN" utile per manipolare/creare i report di stampa col designer Crystal Reports. Business CUBE non fa più uso comunque della fonte dati ODBC quando manda in esecuzione i report.

Sempre nello stesso tab Varie è possibile:

• avviare il programma dell'installazione degli aggiornamenti di Business (Avvia installazione aggiornamenti)
  
• utilizzare la parte "Modifica default campo codditt", che permette di modificare il valore predefinito (default) delle colonne codditt sulle tabelle del database azienda selezionato
  
• utilizzare "Gestisci filegroup secondario", che crea su SQL un secondo filegroup, un file fisico nuovo di tipo .ndf dove le tabelle DWAREHE, ACTLOG e DWDATISTO vengono spostate. Lo scopo è quello di alleggerire il file .mdf principale da dati/tabelle normalmente molto voluminose allo scopo di rendere sql server più performante, a livello gestionale non ci sono cambiamenti.
  
  
• "Crea tabelle allegate" per creare le tabelle allegate in formato access 97 o 2000.
  
• "BusNGEN" Questo strumento, al momento in versione preliminare, serve per procedere alla compilazione nativa dei componenti (DLL ed EXE) delle applicazioni realizzare sul Microsoft .NET Framework 4.x (come Business CUBE): viene eseguita l'utility Microsoft NGEN.EXE del .NET Framework per ogni file DLL o EXE presente nella "Cartella di Business". In questo modo i componenti vengono compilati nativamente sul processore x86 (32 bit) o x64 (64 bit) e l'avvio della applicazione, così come il caricamento dei singoli programmi da menu, risulterà più veloce anche al primo avvio.
  Per avviare la creazione delle immagini native, scegliere l'operazione "Install", indicare "x86" o "x64" a seconda della piattaforma di Business CUBE che si utilizza sulla macchina, quindi premere "Avvia". Questa operazione può durare anche alcune decine di minuti in funzione delle performances. L'operazione agisce sulla macchina corrente quindi se si vuole compiere questa operazione su tutte le macchine, va avviata singolarmente su ciascuna di esse. Lanciando il programma con l'opzione "Uninstall", rimuove le compilazione native precedentemente create con l'operazione "Install" tornando quindi allo stato iniziale. Completata l'elaborazione viene scritta una nuova proprietà nel registro di configurazione sul profilo corrente (nella tabella REGEDIT): la proprietà è denominata BusNGEN32 o BusNGEN64 in base a come si è scelta la piattaforma; quando si esegue il comando "Uninstall" la proprietà viene rimossa.
  Quando si provvede all'installazione di un aggiornamento di componenti (service release cumulative update, hot update) le immagini native precedentemente create vengono invalidate (per i soli componenti DLL/EXE modificati/aggiornati) e tornano ad operare come da standard dove il compilatore Just-In-Time (JIT) compila l'assembly originale ad ogni utilizzo. A partire dalla prossima versione di Business CUBE questa sarà una scelta d'installazione (del Setup in versione completa) in modo tale poi che il programma di installazione aggiornamenti (Busagg) sia autonomo nel creare le immagini nativi mediante NGEN, sui singoli componenti che installa.
  Per maggiori dettagli tecnici su questa funzionalità vedere il link Microsoft https://msdn.microsoft.com/it-it/library/6t9t5wcf(v=vs.110).aspx (Ngen.exe (Native Image Generator).

• "Verifica prestazioni" mediante il quale è possibile eseguire dei test che permettono di misurare le prestazioni della macchina corrente e della rete. Questo strumento è utile per monitorare situazioni in cui Business Cube risponde in modo non adeguato in termini performance. Per ogni tipo di controllo sono indicati dei parametri consigliati di riferimento.

Sezione Backup/Restore

Contiene le funzionalità della Gestione Backup, alla cui guida si rimanda per indicazioni sul suo funzionamento:

Sezione Sicurezza

Può criptare le stringhe di connesioni a SQL presenti sul file profilo ".cfg" e nel programma di Gestione aziende database.

I due CheckBox relativi a Cripta/Decripta le password operatore di accesso al programma:

• se selezionata la "Cripta", procede con la criptazione delle di tutte le password operatori e sarà impostata/creata un'opzione di registro che indica che la criptazione delle password operatori è attiva (BN__GESP\FRM__GESP\.\cri=-1, senza dipendenze operatore, tipo documento, azienda)
• se selezionata la "Decripta", procede con la decriptazione delle password di tutti gli operatori e sarà impostata/cancellata l'opzione di registro di cui sopra (BN__GESP\FRM__GESP\.\cri=0, senza dipendenze operatore, tipo documento, azienda)

Modifica cartelle e stringhe di connessione

Dal pannello "Cartelle" è possibile modificare le cartelle utilizzate da Business.

Dal pannello "stringhe di connessione" è possibile:

• Specificare i nuovi dati del server e/o modificare i dati di accesso.
• Gestisce le stringhe di connessione criptate.
• modificare la stringa di connessione all'Arcproc presente nel file .CFG.
• verificare se la nuova stringa di connessione è valida.
• impostare il tipo di connessione come TRUSTED.
• E' possibile selezionare su quali database effettuare la modifica.
• Usando la funzione "Modifica Stringa di Connessione" il programma verifica che le stringhe generate siano corrette, e in caso non lo siano chiede se si vuole ugualmente salvare la modifica.

Gestione utenti SQL Trusted

vedi anche GDPR Usa sicurezza integrata

Permette di consultare la lista degli utenti di SQL e di creare velocemente nuovi utenti Trusted (verrano creati come indicato nella circolare tecnica "CT-1206-0126-Come utilizzare l'autenticazione Windows integrata (Trusted)").

Il programma mostra la lista delle istanze SQL utilizzate dal profilo corrente di Business, in caso l'arcproc e i database azienda siano dislocati su istanze diverse gli utenti dovranno essere creati per ogni istanza di SQL.

L'utente potrà creare nuovi utenti di tipo Trusted semplicemente selezionandoli dalla lista degli utenti del dominio, selezionando il tipo di utente (tra Amministratore o Utente Semplice) e premendo il pulsante "Crea utente Trusted su SQL".

Questa funzione non permette di modificare gli utenti esistenti: ovvero il passaggio di un utente da Amministratore ad Utente Semplice dovrà essere eseguito manualmente, inoltre gli utenti semplici vengono abilitati solo sui database usati da Business sulla stessa istanza e se dopo la loro creazione vengono aggiunti nuovi database, dovranno essere abilitati da Management Studio.

Sezione Utenti connessi

Permette di inibire la login a Business e inviare messaggi a chi è connesso. Questa funzionalità è utile per vedere chi è connesso a Business e inviare messaggi di servizio agli operatori (ad es. uscire per un aggiornamento):

Se si invia un messaggio (se si spunta il flag apposito lo stesso messaggio viene inviato a tutti gli utenti connessi).

All'operatore che sta lavorando in Business appare la seguente finestra.

Sezione Registro di configurazione

Gestisce la tabella REGEDIT di ARCPROC con le stesse funzionalità del registro di Windows, quindi permette di importare o esportare le proprietà e le chiavi d'attivazione (utile, ad esempio, nel caso in cui si acquisti una chiave che aggiunge un nuovo modulo):

Nella fienstra sono presenti i pulsanti:

Importa chiave Business per importare la chiave di attivazione presente sul file. Importando una nuova chiave di attivazione, con l'apposito pulsante, viene aggiornata anche la chiave eventualmente presente nella cartella \Agg\Setup creata dal SETUP, se esiste già una file di chiave denominato "Chiave attivazione [MATRICOLA].key".

Esporta chiave Business per generare il file con la chiave di attivazione.

Imp. chiave GOW per importare chiavi del verticale gestione ordini web.

Crea record indispensabili nel caso siano presenti altri profili con caricata la chiave di attivazione, chiede se si vuole duplicare la chiave sul profilo corrente.